Wskazówki dotyczące rozwiązywania problemów z łączem i przyciskiem płatności w systemie PayPal

Otrzymuję komunikat o błędzie, a przycisk nie jest wyświetlany w mojej witrynie.

1. Sprawdź, czy działa Twoje połączenie internetowe.
2. Otwórz inne strony swojej witryny i sprawdź, czy ładują się one poprawnie.
3. Przejdź do strony z przyciskami PayPal i sprawdź następujące elementy.
   * Czy przycisk jest wyświetlany w sekcji „Zapisane przyciski”?
   * Wybierz Edytuj i upewnij się, że kod przycisku jest taki jak w treści Twojej witryny.
4. Kliknij prawym przyciskiem myszy stronę produktu (gdzie wklejono kod przycisku) i kliknij „Sprawdź”. Przejdź do karty Konsola (wyświetlanej u góry strony). Mogą zostać wyświetlone błędy CSP. Jeśli zastosowano nagłówek Content Security Policy, mogą zostać wyświetlone następujące błędy CSP (przykładowe błędy CSP):

• Odmówiono załadowania skryptu „https://www.paypal.com/sdk/js**”, ponieważ czynność ta narusza następującą dyrektywę Content Security Policy: „default-src 'self'”. Należy zauważyć, że skrypt „script-src-elem” nie został wyraźnie ustawiony, zatem „default-src” jest używany jako skrypt rezerwowy.
• Odmówiono połączenia ze skryptem „https://www.paypal.com/**”, ponieważ czynność ta narusza następującą dyrektywę Content Security Policy: „default-src 'self'”. Należy zauważyć, że skrypt „connect-src” nie został wyraźnie ustawiony, zatem „default-src” jest używany jako skrypt rezerwowy.
• Odmówiono wykonania skryptu inline, ponieważ czynność ta narusza następującą dyrektywę Content Security Policy: „script-src https://*.paypal.com”. Aby włączyć wykonywanie inline, wymagane jest słowo kluczowe „unsafe-inline”, skrót ('sha256-WYDWDPwB8j2VePYrqy38aHPcJLsasO//lnXymmxscUk=') lub identyfikator jednorazowy ('nonce-...').
• Odmówiono załadowania obrazu „https://tracking.qa.paypal.com/webapps/tracking/ts?**”, ponieważ czynność ta narusza następującą dyrektywę Content Security Policy: „default-src 'self'”. Należy zauważyć, że skrypt „img-src” nie został wyraźnie ustawiony, zatem „default-src” jest używany jako skrypt rezerwowy.
• Odmówiono umieszczenia w ramce „https://www.paypal.com/**”, ponieważ czynność ta narusza następującą dyrektywę Content Security Policy: „default-src 'self'”. Należy zauważyć, że skrypt „frame-src” nie został wyraźnie ustawiony, zatem „default-src” jest używany jako skrypt rezerwowy.

Aby rozwiązać dowolny z powyższych błędów, można spróbować dodać poniższe elementy:

Opcja-1 (HTML): Jeśli w pliku HTML skonfigurowano nagłówek CSP, należy użyć poniższego kodu, aby zastąpić kod CSP

<meta http-equiv="Content-Security-Policy" content="default-src 'self';
script-src 'unsafe-inline' https://*.paypal.com https://*.paypalobjects.com;
style-src 'unsafe-inline' https://*.paypal.com; connect-src
https://*.paypal.com; frame-src https://*.paypal.com; img-src
https://*.paypal.com https://*.paypalobjects.com">

Opcja-2 (po stronie serwera): Jeśli dostawca CSP jest skonfigurowany po stronie serwera, użyj poniższego kodu, aby zastąpić kod Content Security Policy

(CSP): script-src 'unsafe-inline' https://*.paypal.com https://*.paypalobjects.com
CSP: style-src 'unsafe-inline' https://*.paypal.com
CSP: connect-src https://*.paypal.com
CSP: frame-src https://*.paypal.com
CSP: img-src https://*.paypal.com https://*. paypalobjects.com

Jak zmienić układ/rozmiar/kolor nazwy/ceny/ilości produktu?

Aby zmienić układ/rozmiar/kolor nazwy/ceny/ilości produktu w witrynie PayPal:

1. Przejdź do strony Przyciski PayPal.
2. Kliknij przycisk Otwórz obok zapisanego przycisku i wybierz opcję Edytuj.
3. Kliknij Dostosuj przyciski i wprowadź niezbędne zmiany.

Czy po edycji informacji o produkcie (nazwa, kwota lub cokolwiek innego) potrzebuję

ponownie skopiować/wkleić kod przycisku?

Nie, pobieramy wszystkie informacje z serwera PayPal. Po zapisaniu zmian na koncie nie ma potrzeby aktualizowania kodu przycisku kopiowania/wklejania witryny. 

Uwaga: jeśli zmienisz kod waluty na swoim produkcie, należy zaktualizować przycisk płatności.

Widzę identyfikator klienta w kodzie – co on oznacza?

Identyfikator klienta to identyfikator klienta handlowca, który jest częścią Twojego konta. Nie należy go edytować. Należy z niego korzystać w takiej formie, jaka znajduje się w kodzie przycisku.

Pomimo dodania wielu przycisków, żaden z nich nie jest wyświetlany na mojej stronie internetowej.

Szereg przycisków na tej samej stronie internetowej nie będzie działać w następujących scenariuszach:

• Jeśli wielokrotnie skopiowano/wklejono ten sam identyfikator przycisku na tej samej stronie internetowej, pojawi się tylko pierwszy przycisk. Nie można wielokrotnie powtarzać tego samego identyfikatora przycisku.
• Jeśli skopiowano/wklejono różne identyfikatory przycisków, ale w innych walutach na tej samej stronie internetowej, pojawi się tylko pierwszy przycisk. Nie można dodawać walut obcych do przycisków na tej samej stronie internetowej.
• Jeśli skopiowano/wklejono różne identyfikatory przycisków, co doprowadziło do spowolnienia, należy upewnić się, że tag skryptu z identyfikatorem klienta został dodany tylko raz. Wiersz skryptu będzie wyglądał następująco:
  

  • <skrypt src="https://www.paypal.com/sdk/js?client-id=XYZ&components=hosted-buttons&enable-funding=venmo&currency=USD"></script> 

Mam konto Premier PayPal i nie widzę  łączy i przycisków płatności jako

opcji

Ta funkcja jest dostępna tylko na kontach firmowych PayPal. Aby korzystać z tej funkcji, należy rozszerzyć konto do konta firmowego lub je utworzyć.

Jak przetestować personalizację w centrum testowym PayPal?

Łącza i przyciski do płatności można przetestować w Centrum testowym.

Wbudowane rozszerzenie inline transakcji kredytowej/debetowej nie wyświetla się w całości w mojej

witrynie.

Upewnij się, że szerokość i wysokość kontenera nadrzędnego są ustawione tak, aby uwzględnić rozszerzenie inline. Aby uzyskać więcej informacji, zapoznaj się z dokumentacją / pomocą techniczną platformy hostingowej.

Czy łącze do płatności i przyciski obsługują BPP (Błyskawiczne powiadamianie o płatności)?

Tak. Wykonaj poniższe czynności, aby skonfigurować i włączyć błyskawiczne powiadamianie o płatności.

Aby odszukać konfigurację błyskawicznego powiadamiania o płatności w systemie PayPal:

1. Przejdź do Ustawień konta.
2. Wybierz opcję Powiadomienia i Błyskawiczne powiadamianie o płatności.
3. Kliknij Aktualizuj łącze.

Aby włączyć Ustawienia BPP:

1. Dodaj adres URL obsługujący BPP i wybierz opcję Odbieraj komunikaty BPP (włączone).
2. Kliknij Zapisz.

Obsługuj BPP w kodzie swojego serwera:

• Po wybraniu łącza płatności i przycisku transakcji usługa BPP w systemie PayPal wywołuje adres URL powiadomienia skonfigurowany w kroku 2.

Dostęp do historii BPP:

• https://www.sandbox.paypal.com/merchantnotification/ipn/history
• https://www.paypal.com/merchantnotification/ipn/history

Materiały referencyjne

Wstęp: https://developer.paypal.com/api/nvp-soap/ipn/IPNIntro/

Należy użyć prawidłowego adresu URL usługi BPP w kodzie serwera

• Sandbox https://www.sandbox.paypal.com/cgi-bin/webscr
• Live https://www.paypal.com/cgi-bin/webscr

Przykłady dla innych języków GitHub – paypal/ipn-code-samples

Jakie informacje o zakupie

przesyła firma PayPal po skierowaniu klienta na stronę przekierowania? Czy łącza do płatności i przyciski obsługują przesyłanie danych na temat płatności?

Jakie zmienne są obsługiwane?

Tak, obsługujemy zmienne przesyłanie danych na temat płatności (PDT) zgodnie z opisem tutaj. Otrzymasz PDT, jeśli włączysz ustawienie Automatyczny powrót podczas konfigurowania łącza do płatności i przycisku. 

Czy łącza i przyciski do płatności obsługują ustawienia regionalne, jeśli zostały dodane ręcznie przez

handlowca w kodzie przycisku lub łączu do płatności?

Domyślnie łącza i przyciski płatności korzystają z preferencji przeglądarki klientów do wyświetlania kodu przycisku i środowiska łącza do płatności.

Handlowcy mogą nadpisać te ustawienia tylko w przypadku łącza do płatności i kodu przycisku, dodając „locale.x=fr_FR” jako parametr zapytania. Listę obsługiwanych kodów dla ustawień krajowych można znaleźć tutaj. Żaden tekst wprowadzony przez handlowca podczas konfiguracji nie zostanie przetłumaczony.

Przykład: https://www.paypal.com/ncp/payment/F3YMU2ZGT49XX?locale.x=jp_JP

Przykład: 

<script src="……¤cy=USD&locale.x=jp_JP"></script>

Czy można ukryć niektóre etykiety, które pochodzą z płatnych linków oraz

kod przycisku?

Rozumiemy, że możesz mieć inną konfigurację wizualną w swojej witrynie, nie zalecamy jednak ukrywania podanego przez nas kodu przycisku. 

Ukrycie go przed witryną nie zmieni sposobu przetwarzania transakcji. Transakcja nadal będzie korzystać z konfiguracji identyfikatora przycisku hostowanego. 

Można ukryć określony lub cały tekst wokół przycisków, o ile używa się typu przycisku, który nie wymaga wprowadzania danych przez klienta. Na przykład, jeśli klient musi użyć listy wyboru ilości lub wielu pozycji, a te elementy wejściowe zostały ukryte, transakcja zakończy się niepowodzeniem. 

Oto przykład sposobu ukrycia ceny przedmiotu:

Dodaj ten skrypt poniżej kodu przycisku, zastąp identyfikator HostedButton_ID rzeczywistym identyfikatorem przycisku.

Podobnie jak w przypadku ukrywania ceny przedmiotu, możesz zrobić to samo w przypadku innego tekstu:

• desc-label (dla nazwy produktu)
• price-label (dla ceny)

Jeśli chcesz ukryć ich wiele , użyj kodu oddzielanego:

style> #paypal-container-

{ #paypal-form-fields-container-

{ #price-label,  #desc-label { display: none !important; }} }

Jeśli chcesz ukryć cały tekst wokół przycisków, pamiętaj, że typ przycisku nie powinien wymagać żadnych wyborów ani wprowadzania danych przez klienta:

Czy można zastąpić moje łącza do płatności i przyciski, aby korzystać z wysyłki w

Ustawieniach?

Łącza i przyciski do płatności nie będą uwzględniać zbiorczego zastąpienia wysyłki w ustawieniach konta, znanego również jako poniższe ustawienie w Ustawieniach wysyłki.

Waluta przycisku została zmieniona, ale nie jest wyświetlana jako zaktualizowana w

witrynie.

Jeśli zmienisz walutę przycisku już po wklejeniu go na Twojej witrynie, musisz ponownie skopiować/wkleić kod przycisku w swojej witrynie. 

Nie mogę wybrać opcji „Użyj wysyłki z Ustawień” i „Użyj podatku z

Ustawień” po wybraniu opcji „Nie pobieraj adresu wysyłkowego”.

Wysyłka i podatek obecne w Ustawieniach zależą od kraju i/lub kodu pocztowego wysyłki klienta. Jeśli wybierzesz opcję „Nie pobieraj adresu wysyłkowego”, nie otrzymasz z Ustawień adresu wysyłkowego klienta umożliwiającego obliczenie kosztów wysyłki i podatku. Zalecamy skorzystać z innych opcji z menu „Opłata za wysyłkę” i „Stawka podatku”.

Czy płatne łącza i przyciski obsługują elementy webhook?

Tak. Oto jak włączyć elementy webhook:

1. Zaloguj się do panelu programisty przy użyciu danych logowania do rachunku handlowca.
2. Przełącz na usługę Live.
3. Kliknij opcję  Aplikacje i poświadczenia.
4. Przewiń w dół i wybierz opcję Zarządzaj elementami webhook.
5. Teraz możesz dodać adres URL elementu webhook dla usługi Live. Jeśli chcesz dodać elementy webhook do usługi Sandbox, pozostań na tej stronie i przełącz się z Live na Sandbox w prawym górnym rogu strony.
6. Dodaj adres URL wywołania zwrotnego elementów webhook, wybierz wszystkie zdarzenia lub realizację transakcji, zdarzenia płatności, które będą wywoływane przez system PayPal po wybranych zdarzeniach stosownie do implementacji interfejsu API NVP lub SOAP. Wywołaj interfejs API PayPal NVP/SOAP, aby uzyskać informacje o elemencie webhook.

Przykładowa odpowiedź elementu webhook:

"id": "WH-12D11567VE3425924-2G120938U32719946", 
"event_version": "1.0", 
"create_time": "2024-09-14T15:55:58.043Z", 
"resource_type": "capture", 
"resource_version": "2.0", 
"event_type": "PAYMENT.CAPTURE.COMPLETED", 
"summary": "Payment completed for $ 128.88 USD", 
"resource": { 
"supplementary_data": { 
"related_ids": { 
"order_id": "8LM68409BR5528307" 
} 
], 
"id": "7KK30254642170736", 
"status": "COMPLETED"